Changes in QuickTime VR Manager

In the chapter "QuickTime VR Manager," the following changes were made:

In the overview, a reference to creating and managing atoms in a movie resorce was removed.
In Figure 4 , the end values of the pan and tilt angles were changed from radians to degrees.
At the end of the section "Memory Management" , the default allocation of memory for the back buffer was changed to "large enough to hold the entire uncorrected panoramic image."
In the section "Panoramas," the word "pan" was changed to "tilt" in the sentence, "Increasing the tilt angle rotates the object down, while decreasing the tilt angle rotates the object up."
At the end of the section "Panoramas," the following sentence was added: "With version 2.1, QuickDraw VR is capable of using tweening control data that affects the pan angle, tilt angle, and field of view."
The section "Displaying Downloaded Files" was added.
The section "Initializing the QuickTime VR Manager" was added.
Listing 3 "Getting a QuickTime VR movie instance" no longer refers to the movie rectangle and no longer sets the angular units to degrees, which is the default setting.
In the section "Manipulating Viewing Angles and Zooming," in the paragraph about the new viewing angle, the following sentence was added: "The new angle may not be different because, for example, the value was already at some limit or contraint."
In the section "Intercepting QuickTime VR Manager Routines," a sentence about the QTVRTriggerHotSpot function's being valid only for hot spots that link panoramic and object nodes was removed.
In the section "Intercepting QuickTime VR Manager Routines," the constant kQTVRGetHotSpotTypeSelector was added to the definition of QTVRProcSelector.
Listing 7 , "Intercepting the QTVRSetPanAngle function (version 2)," was replaced with a new piece of sample code.
Listing 8 , "Installing an intercept procedure," now refers to QTVRInterceptUPP .
In the section "Entering and Leaving Nodes," the samples now refer to NewQTVREnteringNodeProc and NewQTVRLeavingNodeProc .
At the end of the section "Entering and Leaving Nodes," the paragraph starting with "In a multinode movie" was added.
In the section "Drawing in the Prescreen Buffer," the first paragraph now states that the procedure applies to drawing the panorama, and the sample code now refers to NewQTVRImagingCompleteProc .
Listing 11 , "Overlaying images in the prescreen buffer," has been replaced with a new piece of sample code that draws in one corner of the graphics world rather than drawing the whole thing.
Beginning in the section "Gestalt Selector and Response Values" and throughout the section "QuickTime VR Manager Reference," four-character selector codes are written as FOUR_CHAR_CODE('qtvr') for compatibility with Windows.
In the section "Intercept Selectors," the constant kQTVRGetHotSpotTypeSelector was added to the definition of QTVRProcSelector.
In the section "Intercept Selectors," the constant description for kQTVRGetHotSpotTypeSelector was added to "Constant descriptions" .
In the section "Imaging Modes," the field description for kQTVRCurrentMode was added.
In the section "Imaging Property Types," the field description for kQTVRImagingDefaultValue was modified to direct the user to OR the value with property types to select the default value.
In the section "Transition Properties," the description of the kQTVRTransitionDirection parameter now includes information about the default direction.
In the section "Interaction Property Types," the constant value and field description for kQTVRInteractionNudgeMode were added; the paragraph beginning with "You can get or set the default value" was added; and the last sentence in the field description for kQTVRInteractionPanTiltSpeed was changed to "This property is valid only for panoramas."
The section "Mouse Control Modes" describing the QTVRGetCurrentMouseMode function was added.
In the section "Animation Settings," the constant values and field descriptions for kQTVRPlayEveryViewFrame and kQTVRPlayStreamingViews were added.
The section "Nudge Mode" describing the kQTVRInteractionNudgeMode property was added.
The section "Pixel Sizes" was changed to "Pixel Formats" and information about pixel formats was added.
In the section "Cache Sizes," the constant descriptions for cache sizes were updated to show kQTVRFullCache as the default cache size.
In the section "Intercept Structure," the form of the type definition statement was changed to match the form used in the current header file.
In the section "Floating-Point Point Structure," the name of the data type was updated to QTVRFloatPoint .
In the section "Cursor Record," the name of the record was updated to QTVRCursorRecord and the name of the type field was updated to theType .
In the section "Area of Interest Structure," the name of the record was updated to QTVRAreaOfInterest .
The section "Initializing and Terminating QuickTime VR" was added.
The section "QTVRInteractionNudge" describing the QTVRInteractionNudge function was added.
The section "QTVRGetHotSpotType" describing the QTVRGetHotSpotType function was added.
In the section "QTVREnableHotSpot," the description of the hotSpotValue parameter was changed to specify a value of zero when all hot spots are enabled.
In the section "QTVRSetMouseOverHotSpotProc," the name of the UPP in the definition was updated to QTVRMouseOverHotSpotUPP .
In the section "QTVRMouseEnter," the WindowPtr parameter w was added to the description of the QTVRMouseEnter function.
In the section "QTVRMouseWithin," the WindowPtr parameter w was added to the description of the QTVRMouseWithin function.
In the section "QTVRMouseLeave," the WindowPtr parameter w was added to the description of the QTVRMouseLeave function.
In the section "QTVRMouseDown," the WindowPtr variable w was added to the description of the QTVRMouseDown function and the field description of the Pointpt variable was changed to specify that the cursor location is in the graphics world specified by the w parameter.
In the section "QTVRMouseStillDown," the WindowPtr variable w was added to the description of the QTVRMouseStillDown function and the field description of the Pointpt variable was changed to specify that the cursor location is in the graphics world specified by the w parameter.
In the section "QTVRMouseUp," the WindowPtr variable w was added to the description of the QTVRMouseUp function and the field description of the Pointpt variable was changed to specify that the cursor location is in the graphics world specified by the w parameter.
The section "QTVRMouseStillDownExtended" was added.
The section "QTVRMouseUpExtended" was added.
The section "QTVRGetCurrentMouseMode" was added. The information is the same as in the section "Mouse Control Modes" .
In the section "QTVRSetImagingProperty," the description of the QTVRSetImagingProperty function was changed to specify the value of kQTVRImagingDirectDraw as true for both static mode and motion mode.
In the section "QTVRCoordToAngles," the name of the data type in the definition was updated to QTVRFloatPoint .
In the section "QTVRSetEnteringNodeProc," the name of the procedure in the definition was updated to QTVREnteringNodeUPP .
In the section "QTVRSetLeavingNodeProc," the name of the procedure in the definition was updated to QTVRLeavingNodeUPP .
The section "QTVRGetBackBufferMemInfo" replaced the section "QTVRGetCacheMemInfo." The name of the function was changed from QTVRGetCacheMemInfo to QTVRGetBackBufferMemInfo and the cacheSize parameter was changed to cachePixelFormat .
The section "QTVRGetBackBufferSettings" replaced the section "QTVRGetCacheSettings." The name of the function was changed from QTVRGetCacheSettings to QTVRGetBackBufferSettings and the cacheSize parameter was changed to cachePixelFormat .
The section "QTVRSetBackBufferPrefs" replaced the section "QTVRSetCachePrefs." The name of the function was changed from QTVRSetCachePrefs to QTVRSetBackBufferPrefs and the cacheSize parameter was changed to cachePixelFormat .
In the section "MyImagingCompleteProc," the following sentence was added to the section "SPECIAL CONSIDERATIONS" : "If your application has installed a prescreen buffer imaging completion procedure, QuickTime VR temporarilty overrides the setting of the kQTVRImagingDirectDraw property and calls your MyImagingCompleteProc function after drawing into the prescreen buffer."

Previous | Overview | Contents | Next